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Abstract: This subroutine is an debugging aid and traces the sequenc 
of program instruction execution. 


Before each execution of an instruction, the routine prints 
following data: 


a. Instruction to be executed 
b. The location of the instruction to be executed 
c. The contents of the operands in the instruction 


The routine is particularly useful in the following 


situation. 
= . ait 
1- A user program is written in Assembler and has a 
serious bug but don't know how it happens. OF ok, 
2. A user program is so huge that it is very hard to yw 
narrow down or find what part of the program coding yy 


is making trouble. vv 


The format of the dynamic tracer call is described here. 


Format: 
col.1- -.s. col,-10--- ~ col. 16- . ; a= 
CALL TRACE, (start-addr,upper-limit) 

CALL; External subroutine call 

TRACE The subroutine name of DYNAMIC TRACER 

start-addr: Tracer starting point 

upper-limit: Highest address that the tracer can print. 
Example: 


CALL TRACE, (TAG2,LAST) 
TAG2 LA 3,H6+1 
LA 4,MAX 





o 


The dynamic tracer traces the user program coding only 
and does not trace the system routine such as: 


®& - system supervisor routine branched by SVC instruction 
, - Logical IOCS routine branched by BALR 14,15 instruction. 


I/O device: The dynamic tracer uses printer I/O, therefore following 
device assignment is requested, and included in the user 
JCL. 


// DVC 21 // LFD PRNTR2 


Usage: The dynamic tracer is only to trace the sequence of the inst- 
ructions execution, therefore the repetitive use of the 
tracer should be avoided. It produces a large volume of 
printer spool file so easily, therefore after getting 

.@nough tracer dump, the job sould be cancelled. 


Sample printout of the dynamic tracer: 
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Explanation: 


Line 1 indicates the start of Dynamic tracer routine, and the start 
point is TAG2, highest printable address is LAST. i 


Line 2. Link Map shows the ORIG ADDR of CALEN is '13C0'hx and line 2 
location is '088A' therefore the actual location of the line 
@ instruction is '13c0' + '088A' = '1C4A', This is shown in 
the column 1 of the tracer dump line Ql). : 





Trace dump output 


col. 1 : Location of the traced program instruction 


col. 2 : Executed instruction. 
Line of the source code is LA instruction and its object 
- code is 413022EA. The same code appears in col. 2 of the 
tracer dump. See line GQ) of the dump. 


col 3: content of operand-1. (Before execution) 


In this example, the instruction in line(2) is LA and in this 
case, the operand-l is register-3. 

The content of register-3 BEFORE the execution was ‘OOOO1BAE'. 
After the execution, the content of register - -3 must be equal 
to the operand of OP2. 


col. 4 : Content of operand-2. (Before execution) 


Again, in Line Q) the instruction is LA, and in this case 
the operand-2 consists of the content of register-2 plus 
'2EAthx. 


Line G1) indicates the OP2 result was '16AC'. This value 
will be stored to register-3 as the result of this instruction 
execution. 


col. 5 : Content of operand-2 for SS-type instruction 


For SSl and SS2 type instraction, the content of OP1 and OP2 
will be printed in Hex. And regardless of the length of both 
operands, there will be 16 hex. print out, therefore, if the 
operand is shorter than the printed length, then ignore the 
excess character. If too long, then the exceeding part will 
not. be seen. 


Source line ©) is a CLC instruction and this is a SSl type 
instruction, and comparing only first 3 bytes , but 16 

hex bytes are printed. The gperand-1 and 2 are divided by 
2 asterisks. See the line Ga} of the trace dump. 





